home *** CD-ROM | disk | FTP | other *** search
/ HPAVC / HPAVC CD-ROM.iso / TONELOC.ZIP / TL-REF.DOC < prev    next >
Text File  |  1991-11-27  |  11KB  |  251 lines
  1.                       ToneLoc v0.95 Reference Manual
  2.  
  3.                                    by
  4.  
  5.                         Minor Threat & Mucho Maas
  6.  
  7.      This is the reference manual.  You should read this AFTER reading
  8. TL-USER.DOC unless:
  9.  
  10.      1. You are already familiar with Toneloc             -or-
  11.      2. You want to get started quickly
  12.  
  13.  
  14.  ------------------------
  15.    COMMAND LINE OPTIONS
  16.  ------------------------
  17.  
  18. Here are the command line options for ToneLoc:
  19.  
  20. Toneloc  [DataFile] /M[Mask] /X[ExMask] /C[Config] /S[StartTime]
  21.          /E[EndTime] /H[Hours] /T[-] /K[-]
  22.  
  23.      ToneLoc must ALWAYS be run with at least one parameter, and if you
  24. only use one parameter it MUST be the dialing mask to use.  If you only
  25. give ToneLoc one parameter, the first 8 characters of the dialing mask
  26. will also be the data file name.  So if you run "TONELOC 555-XXXX", the
  27. mask will be 555-XXXX and the data file will be 555-XXXX.DAT.
  28.  
  29.      /M - Dial Mask.  Use this parameter if you want to use a data file-
  30.           name other than your dialing mask.
  31.  
  32.      /X - Exclude dial mask.  This tells ToneLoc to -NOT- dial certain
  33.           numbers.  For example, if your local Police department has
  34.           phone numbers ranging from 555-5000 to 555-5099, and you were
  35.           using the dial mask 555-5XXX, use the exclude mask 50XX. This
  36.           mask applies to the active part of the dial mask (in this case
  37.           5XXX) and therefore should be no more than 4 characters long.
  38.           If an exclusion mask is longer than 4 characters, ToneLoc will
  39.           ignore it. All exclusions must be sub-sets of the dialing mask.
  40.  
  41.      /C - Config File.  This tells toneloc to use an alternate config
  42.           file.  The default is TONELOC.CFG, but you may change this
  43.           for different types of scans.  Scanning for carriers, for
  44.           example, usually requires 30-45 seconds while tones only
  45.           require 15-20 seconds.  You might have two config files for this.
  46.  
  47.      /S - StartTime.  Tells ToneLoc to wait until a certain time to begin.
  48.           You may either use military time or end the time with a "p" for
  49.           P.M.  Example:  5:30p and 17:30 are the same.
  50.  
  51.      /E - EndTime.  Tells ToneLoc to STOP dialing at a certain time.  Use
  52.           the same notation as the /S parameter above.
  53.  
  54.      /H - Hours.  Tells ToneLoc to dial for a certain number of hours
  55.           after starting, and then exit.  "/H5:30" would mean 5 hours,
  56.           30 minutes.
  57.  
  58.      /T - Sets the scan mode to look for tones, overriding whatever is
  59.           specified in the config file. /T- will look for everything
  60.           >except< tones.
  61.  
  62.      /K - Sets the scan mode to look for carriers, overriding whatever is
  63.           specified in the config file. /K- will look for everything
  64.           >except< carriers.
  65.  
  66.      These parameters may appear in any order, EXCEPT the first parameter
  67. MUST always be the datafile, and if you do not specify a dial mask with
  68. /M it MUST ALSO be the mask.
  69.  
  70.  -----------------
  71.    WHILE DIALING
  72.  -----------------
  73.  
  74.      While ToneLoc is scanning, there are several keys that do various
  75. things.  Here they are:
  76.  
  77.      J - Pressing 'J' will Jump to a DOS shell.  Upon returning,
  78.          ToneLoc will redial the last number.
  79.  
  80.      N - This will "Note" the current number by putting a special entry
  81.          in the logfile.  It looks like this: "* Noted *".  Use this if
  82.          you want to remember this number for later.
  83.  
  84.      R - This will redial the current number.
  85.  
  86.      S - This toggles the modem speaker ON or OFF while dialing.
  87.          Toneloc will play a noise to indicate the status of the speaker
  88.          if sound is enabled. Once the current dial is finished the speaker
  89.          will be toggled.
  90.  
  91.      X - This will extend the current dial time by 5 seconds.  The
  92.          meter will reflect the time addition.
  93.  
  94.      0-9 - These are the modem volume changing keys.  They will send
  95.          the corresponding string in the config file to the modem.  They
  96.          work like 'S'.
  97.  
  98.      [Escape] - Pressing Escape will abort the current number and
  99.          exit ToneLoc.
  100.  
  101.  ----------------------
  102.    CONFIGURATION FILE
  103.  ----------------------
  104.  
  105.      ToneLoc uses a configuration file.  Before running ToneLoc, you
  106. need to edit this config file for your setup.  The config file has
  107. a little bit of help in it, so it should be self-explanatory.  But just
  108. in case, here's an explanation of each keyword in the configuration file.
  109.  
  110.      Port - This is which COM port to use.  ToneLoc has been tested
  111.             on COM1 - COM4 successfully.  It should, theoretically,
  112.             work up to COM16.  See your FOSSIL documentation for details.
  113.  
  114.      Baud - This is the baud rate at which ToneLoc communicates with
  115.             the modem.  For an HST or DS, it should be 38400.  (No
  116.             commas allowed).  If you have problems with dropped characters,
  117.             lower this to 19200 or 9600.
  118.  
  119.      Speaker - This tells if the modem speaker should start ON or OFF.
  120.             The word "On" or "Off" should follow "Speaker".  You may
  121.             toggle the speaker while dialing by pressing 'S'.
  122.  
  123.      FoundSound - ToneLoc can make a noise when it finds something -
  124.             if you want this enabled set it to 1.
  125.  
  126.      Sound - ToneLoc can makes noises for speaker toggles and volume
  127.             changes. If you want to hear these sounds, set this to 1.
  128.  
  129.      InitString - This is the string that is sent to the modem when
  130.             ToneLoc is first run.  Usually this is ATZ.  You may need
  131.             to send other parameters like ATX7, etc.  Use the characters
  132.             | for [Enter] and ~ (tilde) for a 0.5 second delay.
  133.  
  134.      InitResponse - ToneLoc checks for this after initializing the modem.
  135.             If the modem doesn't send this back, toneloc will try to
  136.             initialize the modem up to 3 times.  If it doesn't work,
  137.             ToneLoc exits.
  138.  
  139.      DialString - This is the string to dial the modem.  Usually "ATDT".
  140.             If you need to dial *70 to disable call waiting, for example,
  141.             add it here like "ATDT*70".  Or if you need to dial "9" first,
  142.             put it here.
  143.  
  144.      SpeakOn - String to send to the modem that turns the speaker ON.
  145.             Usually "ATM1"
  146.  
  147.      SpeakOff - Same as above, but to turn the speaker off.  Usually "ATM0"
  148.  
  149.      Volume0-Volume7 - Strings that adjust the volume of the modem while
  150.             dialing.  Press '0' - '7' while dialing to adjust the modem
  151.             volume.  You could also use these as other macros besides
  152.             volume.
  153.  
  154.      Hangup - String that tells the modem to hang up.  Usually "ATH0"
  155.  
  156.      LogFile - File that toneloc logs it's activity to.  Usually TONE.LOG
  157.  
  158.      CommandDelay - Delay between modem commands.  Usually 200 or so.
  159.  
  160.      BetweenDelay - Delay between dial attempts.  If you have 3-way
  161.             calling, you'll need to set this to a higher number.
  162.  
  163.      BetweenWipe - How to 'wipe' the fancy meter between calls.
  164.             1 = Edges to Middle
  165.             2 = Middle to Edges
  166.             3 = Backwards
  167.             4 = No wipe
  168.  
  169.      WaitDelay - How many milliseconds to allow each dial attempt before
  170.             hanging up and trying the next number.  For tones this should
  171.             be 15000 - 20000.  For carriers, 30000 - 45000.
  172.  
  173.      NoDupes - This tells toneloc to never dial the same number twice
  174.             within a dial mask.  This should usually be on.
  175.  
  176.      MaxRing - This tells ToneLoc to abort the current dial after a
  177.             certain number of rings.  For PBX scanning, this is usually
  178.             2.  For carriers it should be 4 or 5 or more.  If you specify
  179.             0, ToneLoc will not abort on rings.
  180.  
  181.      ScanType - Tells ToneLoc to scan for either Tones or Carriers, or
  182.             everything except Tones or Carriers.
  183.             0 = Tones
  184.             1 = Carriers
  185.             2 = Everything except tones
  186.             3 = Everything except carriers
  187.  
  188.      IgnoreCD - If your modem always sets Carrier Detect (CD) as TRUE
  189.             turn this on.  Otherwise, turn it off.
  190.  
  191.      AutoSave - This is the number of minutes ToneLoc should wait
  192.             between automatic backups of the .dat file. If set to 0 it
  193.             will only save on exit.
  194.  
  195.      FoundFile - This is the name of the file where ToneLoc should store
  196.             the found numbers (tones or carriers.)
  197.  
  198.      Blacklist - This is a file containing numbers you don't want ToneLoc
  199.             to dial.  You could put in your own numbers, your friend's
  200.             numbers, the police department, etc.
  201.  
  202.      Random/Forward/Backward - ToneLoc's default mode is to dial numbers
  203.             randomly without duplication, but it can also dial forwards
  204.             and backwards sequentially. Set this to the keyword you want.
  205.  
  206.      Logging - This sets whether ToneLoc should keep a log file or not.
  207.  
  208. -----------------
  209.   DESQview INFO
  210. -----------------
  211.  
  212.      ToneLoc runs most excellently under DESQview.  It will detect
  213. DESQview, and if DESQview is found, screen writes are directed to the
  214. screen buffer so your screen isn't trashed.  ToneLoc also releases
  215. unneeded timeslices to DESQview.  Because of this, ToneLoc uses VERY
  216. LITTLE CPU time, so you can run it in background with minimal slowdown.
  217. I tested ToneLoc with two windows open.  One was a DOS window sitting
  218. at the prompt idle (doing nothing).  The other was ToneLoc scanning.
  219. ToneLoc used about 10% of the CPU time, and the idle DOS window used
  220. about 88% (with about 2% DESQview overhead).
  221.      The file "TL-PIF.DVP" is included with ToneLoc.  To add ToneLoc
  222. to your DESQview setup, do the following:
  223.  
  224.      1. Run DESQview
  225.      2. Choose "Add a Program"
  226.      3. Type 'O' for other
  227.      4. Enter the path where ToneLoc is found
  228.      5. Move the cursor bar to "ToneLoc" and hit [Space Bar]
  229.      6. Press [Enter].
  230.  
  231. ToneLoc will be added to the list of applications on your DESQview menu.
  232. To run ToneLoc, choose "TL" from the application menu.  You will be placed
  233. at the DOS prompt with "ToneLoc " already typed.  Just finish the command
  234. line and press enter.
  235.  
  236. ---------------
  237.   FOSSIL INFO
  238. ---------------
  239.  
  240.      ToneLoc also requires a FOSSIL driver.  The two most popular are
  241. called X00 and BNU.  Just call your local PD board and search for
  242. "FOSSIL", "BNU", and "X00".  We like BNU because it is 7K and can be
  243. unloaded from memory.  New versions of X00 may also be unloaded, but
  244. it requires more RAM.  Both may be loaded HIGH if you're using QEMM-386.
  245.  
  246. --------------------------------------------------------------------------
  247.  
  248. If this doc file sucks, please let me know.
  249.  
  250.  -- Minor Threat
  251.